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{ ) a RELEASE UPDATES 
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If you are new to RealPix, start with “Introduction” on page 4. If you 
have worked with RealPix using an earlier version of this manual, 
this section provides a quick look at how the manual has changed. 


Updates for RealSystem 8 


The following RealPix feature works with RealPlayer 7 or later. 


New Attributes for the <image/> Tag 


The <image/> tag, which defines the names and handles for image files, can 
include size and mime attributes. These attributes give the size of the image file 
in bytes, and the image file’s mime format, respectively. They are useful when 
delivering RealPix with a Web server. See <image/> on page 24 for more 
information. 


Updates for RealSystem 7, Update 1 


The following sections describe new features in Release 7, Update 1 of RealPix. 
RealPlayer 7 or higher is required to play RealPix clips that use the following 
new features. RealServer 7 with Update 1 (or a higher version of RealServer) is 
required to stream clips using these new features. 


PNG Image Support 
RealPlayer and RealPix now support the PNG image format in addition to the 
JPEG and GIF formats. RealPix supports all PNG functions except gamma 
settings. 


Transparency Support 
RealPix now supports transparency in GIF and PNG images. Transparency is 
not maintained between regions in a SMIL presentation, though. See 
“Transparency” on page 46 for more information. 
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RealPlayerPop-Up Window Support 


RealPlayer 7 or higher can pop up new windows when the viewer clicks a 
hypertext link in RealPlayer. RealPix now supports these pop-up windows 
through its url attributes. See “Pop-Up Windows” on page 46 for more 
information. 


Updates for Release 7 


The following sections describe new features in Release 7 of RealPix, as well as 
changes and corrections to this authoring guide. 


New Features 
RealPlayer 7 or higher is required to play RealPix clips that use the following 
new features. Unless otherwise noted, though, the clips can be streamed from 
RealServer G2 Gold, or RealServer 7. 


Grayscale JPEGs Now Supported 
RealPix now supports grayscale JPEGs in addition to RGB JPEGs. Progressive 
JPEGs cannot be used with RealPix, however. Streaming grayscale JPEGs 
requires RealServer 7. 


Background Color in <head/> Tag 


You can now include a background color in the <head/> tag. See “background- 
color” on page 19. 


New <animate/> Tag 


The new <animate/> tag controls how long an animated GIF cycles through its 
frames. See page 35 for more information. 


Simultaneous Effects 


RealPix now supports simultaneous effects. For example, you can now fade in 
two images at the same time. Sample files included with the on-line version of 
this manual illustrate simultaneous effects. RealNetworks recommends that 
you keep the destination rectangles distinct when you use simultaneous 
effects. Do not fade two images into overlapping areas, for instance. 
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Changes and Corrections 


RealPix Broadcast Application Moved to Authoring Kit 


The RealPix broadcast application has been removed from the HTML version 
of this authoring guide. The broadcast application is now part of the 
RealSystem Authoring Kit, available through registration at 
http://www.realnetworks.com/products/authkit/index.huml. 
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RealPix, part of RealSystem, lets you stream images across an 
intranet or the World Wide Web. By combining images with media 
such as audio and text, you can create compelling presentations for 
many purposes. This guide explains how to create RealPix 
presentations using graphics files and a simple mark-up language 
you use to specify visual effects. If you know HTML, you will master 
RealPix mark-up quickly. 


Note 
The HTML version of this manual, available at 
http://service.real.com/help/library/encoders.html, 


contains RealPix examples you can view with RealPlayer. 


Tools for Creating RealPix 
You will need the following tools to create and test your RealPix presentation: 
- Image Editing Software 


Image software such as Adobe Photoshop lets you create images in 
formats RealPix can stream. You should know the basics of creating 
graphics for the Web, such as JPEG compression and GIF color palettes. 


- Text Editor 


A RealPix file lists the images used in the presentation, creates the 
presentation timeline, and specifies the visual effects used. To create this 
file, you can use any text editor or XML editor that can save output as 
plain text. 


- RealPlayer 


Use RealPlayer, available free at http://www.real.com, to test your 
RealPix presentation. Other applications may also have RealPlayer 
features that enable them to receive RealPix as well. Note that previous 
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versions of RealPlayer, such as RealPlayer 4.0 and 5.0, cannot display 


RealPix. 
- RealServer 


RealServer streams your RealPix presentation to RealPlayer. If you are not 
operating RealServer yourself, you need to have access to RealServer 
through, for example, an Internet Service Provider (ISP). Note that 
previous versions of RealServer cannot stream RealPix. 


« Microsoft Excel 97 


You will need this spreadsheet program to use the RealPix Bandwidth 
Calculator described in “Calculating Bandwidth Use” on page 53. 


Conventions Used in this Manual 


The following table explains the conventions used in this manual. 


Notational Conventions 





Convention Meaning 

variables Italicized text represents variables. Substitute values 
appropriate for your situation. 

[options] Square brackets indicate optional values you may or may 


not need to use. 





choice 1|choice 2 


Vertical lines separate values you can choose between. 








Ellipses indicate nonessential information omitted from 
the example. 


Additional RealSystem Resources 


In addition to this manual, you may need the following RealNetworks 
resources, available at http://service.real.com/help/library/encoders.html: 


+ RealSystem Production Guide 


This manual explains the basics of streaming files with RealSystem. It tells 
how to calculate bandwidth needs and shows how to put a multimedia 
presentation together. 


+ RealPix Broadcasting 


This technical blueprint explains how to use a simple application to 
broadcast RealPix images. The broadcast application and technical 
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blueprint are included in the RealSystem Authoring Kit, available at 
http://www.realnetworks.com/products/authkit/index.huml. 
- Embedded RealPlayer Extended Functionality Guide 


This guide supplements RealSystem Production Guide. It explains how to use 
JavaScript or VBScript to control RealPlayer functions for a presentation 
embedded in a Web page. 


« RealServer Administration Guide 


The basic reference for the RealServer administrator, this manual explains 
how to set up, configure, and run RealServer to stream multimedia. You 
need this manual only if you are running RealServer yourself. It is 


available at http://service.real.com/help/library/servers.html. 
- RealSystem Software Development Kit (SDK) 


The RealSystem SDK lets you integrate applications with RealSystem. A 
knowledge of programming is required to use the SDK. Register for and 
download the SDK from http://www.realnetworks.com/devzone/. 


Technical Support 
For technical support with RealPix, please fill out the form at: 


- http://customerrelations.real.com/scripts/rnforms/contact_tech 
_Service.asp 
The information you provide in this form will help technical support 
personnel to give you a prompt response. For general information about 
RealNetworks' technical support, visit: 


- http://service.real.com/help/call. html 





pe 





REALPIX AUTHORING 


pi? 


With RealPix you can create streaming images, combining them 
with other media clips such as audio or text. This chapter explains 
the basics of RealPix authoring and streaming. 


Image Formats 
RealPix can stream images in these formats: 
+ GIF87a, GIF89a, and animated GIF (.gif) 
Both interlaced and noninterlaced GIFs will work, but RealPix does not 
take advantage of any features of interlaced GIFs. Noninterlaced GIFs are 
therefore recommended. Transparency is maintained within a RealPix 


clip, but not preserved across regions when the RealPix clip is part of a 
SMIL presentation. 


* JPEG (-ipg) 
RealPix can use RGB baseline and grayscale JPEGs. Progressive JPEGs are 
not supported. 


« PNG (.png) 


RealPix supports all PNG functions except gamma settings. Transparency 
is maintained within a RealPix clip, but not preserved across regions when 
the RealPix clip is part of a SMIL presentation. 


With the images ready, you simply create a RealPix file with mark-up similar to 
HTML. This mark-up describes how and when the images display, specifying 
special effects such as a fade to a solid color or a “wipe” transition between two 
images. 


Image Caching 


Because RealPlayer does not maintain a disk cache or allow users to copy or 
download images, users do not have access to copyrighted materials in a 
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RealPix presentation. RealPix caches images in memory as long as they are in 
use, however. A RealPix presentation can thereby reuse an image without 
consuming additional bandwidth. Each cache is specific to each RealPix 
presentation, though. A RealPix presentation does not have access to the 
image cache of another presentation playing concurrently. 


Hosting a RealPix Presentation 


Use RealServer instead of a Web server to host your RealPix presentation. 
When delivered by RealServer, images in a RealPix presentation stream at 
different times depending on their place in the RealPix timeline. This lets you 
structure a RealPix presentation to keep it flowing smoothly. When delivered 
by a Web server, however, all RealPix images begin to download as soon as 
presentation playback begins. This causes a higher preroll. 


Additional Information 
See RealSystem Production Guide, available at 
http://service.real.com/help/library/encoders. html, 


for more on RealServer and Web server hosting. 


The technical blueprint RealPix Broadcasting explains how to use a simple 
application to broadcast RealPix images. The broadcast application and 
technical blueprint are included in the RealSystem Authoring Kit, available at 
http://www.realnetworks.com/products/authkit/index.html. 


Preparing Images 
For a RealPix presentation, you can use scanned pictures, clip art, or images 


downloaded from the Web. When preparing your presentation, maintain three 
separate sets of images: 


1. Original set 


The original set includes the unedited files you start with, such as original 
images off a scanner. Keep this set in case you need to change an image in 
the working set by, for example, restoring an area you cropped out. Leave 
these images uncompressed. 


2. Working set 


The working set comprises the files you have edited. You may have 
cropped the original images or combined them to form new images, for 
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example. Keep these files uncompressed so that you can edit them later if 
necessary. 


3. Presentation set 


This set consists of the compressed files used in the presentation. For a 
given working set, you may have several presentation sets. For instance, 
you may have slightly compressed images for a high-bandwidth 
presentation, heavily compressed images for a low-bandwidth version. 


Establishing a Timeline 


If your presentation consists solely of streaming RealPix images, you have full 
control over the RealPix timeline. When you combine RealPix with another 
component such as RealAudio or RealText, however, the other component 
may establish the timeline. You then need to coordinate the RealPix images 
with the other clip’s existing timeline. In these cases it is better to finish the 
other component first, then assemble your RealPix presentation to the final 
timeline. 


When working with an audio track, for example, think about the order of the 
images, deciding at which points in the audio timeline each image must 
display. When you are ready to assemble your RealPix presentation, play back 
the audio and note where you want to add an image. This will establish your 
RealPix presentation timeline. 


Once you have a timeline for your presentation and have ideas about how to 
place the images, you are ready to create a RealPix presentation. You may find 
it easier to create a storyboard to lay out the transitions and effects. Or you 
may want to dive right in, using the presentation in progress as your guide. 
Either way, carefully consider the bandwidth implications as you place your 
image and set the start times and durations. 


Additional Information 
For more on bandwidth, see “Bandwidth Usage” on 
page S1. 


Using JPEGTRAN 


JPEGTRAN is a freeware program that optimizes JPEG (.jpg) images for 
streaming with RealPix. It modifies them so that if a packet of image data is 
lost, RealPlayer can still decode and display remaining packets. If you do not 
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use JPEGTRAN on your images, RealPlayer cannot decode packets following a 
lost packet, and a substantial part of the image may not display. Windows 
(jpegtran.exe) and Macintosh (jpegtran.sit, a binhexed archive compressed with 
Stufflt) versions are included in the utils directory of the HTML version of this 
manual. 


Note 
Download the HTML version of this manual from 
http://service.real.com/help/library/encoders.html 
to get these tools. 


Running JPEGTRAN on Windows 


To use JPEGTRAN, first create JPEG-format images with the image editor of 
your choice. Then run JPEGTRAN from the command line on Windows 32-bit 
operating systems.From the directory that holds the JPEGTRAN program, use 
this command to process an image: 


jpegtran -restart 1B -outfile output.jpg input.jpg 

Here is an example in which the input is image.jpg and the output is 
newimage.jpg: 

jpegtran -restart 1B -outfile newimage.jpg image.jpg 


You can run JPEGTRAN on one image at a time. 


Additional Information 
You can run jpegtran.exe in batch mode from the 
RealPix Bandwidth Calculator. For more information 
on the calculator, see “Running JPEGTRAN from the 
Calculator” on page 55. 


Running JPEGTRAN on Macintosh 


To use JPEGTRAN, first create JPEG-format images with the image editor of 
your choice. Then move the JPEGTRAN utility to the folder that contains 
your image files. Double-click the JPEGTRAN icon to launch the utility. In the 
argument field, enter the following, specifying a different output file name 
from the input name: 


-restart 1B input_file output_file.jpg 


Here is an example in which the input is image and the output is newimage.jpg: 
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-restart 1B image newimage.jpg 


You can run JPEGTRAN on one image at a time. 


Warning 
The utility may corrupt your image if you use the same 


file name for both input and output. 


Creating a RealPix Presentation 


The following steps describe how to create a RealPix file. A following section 
describes the RealPix mark-up tags in detail. 


> To Create a RealPix Presentation: 


1. Prepare your image presentation set. If you are using JPEG images, run the 
JPEGTRAN utility on them to prepare them for streaming. 


Additional Information 
For more on this utility, see “Using JPEGTRAN” on page 
9. 


2. Open a new text document in your text editor. At the top of the file, add 
the <imfl> tag. Add the </imfl> end tag at the bottom: 
<imfl> 
...All Other Mark-up Goes Between These Tags... 
</imfl> 

3. Between the <imfl> and </imfl> tags, add the mark-up that defines how 
and when the RealPix images appear: 


<imfl> 


<image handle="1” name="drums.jpg”/> 
<image handle="2” name="franklin.jpg” /> 
</imfl> 
Additional Information 


See “Tag Descriptions” on page 18. 


4, Save the file as plain text, using the .rp extension to mark the file as a 
RealPix file. On your local machine, open the RealPix file with RealPlayer 
to test the presentation. 
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Note 
Playing a RealPix file on your local machine indicates 
whether the RealPix mark-up is correct. However, it does 
not guarantee that the file will stream across a network 
well. See “Bandwidth Usage” on page 51 for information 
on making a RealPix presentation stream well. 


5. To combine RealPix with another file, create a SMIL file that controls the 
overall presentation. For example, the SMIL file can list a RealPix file and 
an audio soundtrack to be played together: 
<smil> 

<body> 
<par> 
<ref src="rtsp://realserver.company.com/pix/ads.rp”/> 
<audio src="rtsp://realserver.company.com/pix/ads.ra”/> 


</par> 
</body> 
</smil> 


Additional Information 
See RealSystem Production Guide available at 
http://service.real.com/help/library/encoders.html 


for information about creating a SMIL file. 


6. Move your files to RealServer. If you are using an Internet Service 
Provider, for example, contact the ISP’s RealServer administrator for 
instructions on doing this. 


7. In your Web page, add a hypertext link to the SMIL file. Or if the RealPix 
file is the only file in your presentation, simply link to that file. 


Additional Information 
RealSystem Production Guide available at 
http://service.real.com/help/library/encoders. html 
explains the options for linking your Web page to your 
presentation. It also explains how to play your RealPix 
presentation in your Web page rather than in RealPlayer. 


8. Test the RealPix presentation by clicking the hyperlink in your Web page. 
This launches RealPlayer, which displays the streaming images with the 
properties you defined through the RealPix mark-up. 
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Controlling Image Size, Placement, and Aspect 


In your RealPix file you define a presentation display window. When 
RealPlayer plays your presentation, it expands its main window to this size (or 
larger if your presentation contains multiple clips laid out with SMIL). To 
create a simple presentation such as a basic slide show, you can simply fade the 
images in and out of the display window. Images the same size as the 
presentation window appear full-size. Larger images shrink to fit the window, 
smaller images expand. 


You may want to display just a portion of a source image, however. Or you may 
want to display two images side-by-side. RealPix lets you specify the area of a 
source image that appears in the display window. It also lets you determine the 
size and placement of images in the display window. To understand how this 
works, keep in mind the following definitions. 


Source Image 

An image used in your presentation. A presentation may display one source 
image at a time, or it may display several source images arranged in a 
checkerboard pattern, for instance. 


Display Window 

The RealPlayer window in which your presentation plays back. You set the 
display window size with the RealPix<head/> tag’s width and height attributes 
(see page 19). 


Source rectangle 

The portion of a source image you want to display. You might want to display 
only the top half of a source image in the display window, for example. You 
can think of the source rectangle as a cropped version of your source image. 


Destination rectangle 

The area of the display window where the source rectangle appears. Think of 
the destination rectangle as a separate window within the RealPlayer display 
window. The source and destination rectangles do not have to be the same 
size. 


Defining Image Size and Placement 


To use just a portion of a source image or the display window for an effect, you 
define the source or destination rectangle (or both) ina RealPix tag. To do 
this, you work with these attributes: 
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“srcx” or “dstx” 
Horizontal coordinate in pixels for the left-hand corner of the source 
rectangle (srcx) or destination rectangle (dstx). 


“srcy” or “dsty” 

Vertical coordinate in pixels for the left-hand corner of the source rectangle 
(srcy) or destination rectangle (dsty). For example, the upper, left-hand corner 
of the source image is identified as srcx="0", srcy="0". The upper, left-hand 
corner of the destination window is identified as dstx="0", dsty="0". 


“srcw” or “dstw” 
Width of the source rectangle (srcw) or destination rectangle (dstw) in pixels. 
A width of 0 (zero) is assumed to be the source image’s or destination 


window’s default width. 


“srch” or “dsth” 


Height of the source rectangle (srch) or destination rectangle (dsth) in pixels. 
A height of 0 (zero) is assumed to be the source image’s or destination 


window’s default height. 


Placement Examples 


In the example below, both the source image and destination window are 256 
pixels high by 256 pixels wide. The source tags make the top, left quadrant of 
the source image display in the destination window, effectively magnifying the 
source rectangle by a factor of 2. Because the destination rectangle defaults to 
the destination window size, no destination rectangle coordinates are needed. 
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Part of the Source Image Filling All of the Destination Window 


256 


te 





source destination 
srcx="0" srcy="0" srch="128" srcw="128" 
In this next example, the source image displays in the top, right quadrant of 
the destination window, effectively reducing the size of the source image by 
half. No source coordinates are included, so the entire source image displays 
in the destination rectangle. 


All of the Source Image Filling Part of the Destination Window 





destination source 
dstx="128" desty="0" dsth="128" dstw="128" 


This last example shows a portion of the source image displayed at a slightly 
larger size in the display window. In this case, both source and destination 
coordinates are given to define the source and destination rectangles. 





15 


RealPix Authoring Guide CHAPTER 1: RealPix Authoring 





Part of the Source Image Filling a Part of the Destination Window 


256 





128 
source destination 
srcx="0" srcy="0" srch="128" srcw="128" 
dstx="64" dsty="32" dsth="192" dstw="192" 
Note 


A source or destination attribute defaults to 0 (zero). 
Zero for height or width means the source image or 
destination window’s default height or width. You can 
therefore leave an attribute out to set x to “0,” y to “0,” w 
to the default width, or h to the default height. 


Controlling Image Aspect 


In the examples above, the source and destination rectangles all have height- 
to-width ratios of 1:1. This may not always be the case in your RealPix 
presentations. When source and destination rectangles have different height- 
to-width ratios, the RealPix <head/> tag’s aspect attribute (see page 23) 
determines how the source image displays. 


When aspect is "true", RealPix keeps a source rectangle’s height-to-width ratio 
constant when the destination rectangle has a different ratio. For example, a 
source rectangle’s height-to-width ratio of 1:1 stays constant even if the 
destination rectangle’s height-to-width ratio is 2:3. 


In these cases, RealPix centers the source rectangle in the destination 
rectangle. It scales the source and preserves its height-to-width ratio until one 
dimension reaches the rectangle’s boundaries and the other dimension is 
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within the boundaries. The existing background shows through any part of 
the destination rectangle not filled by the source rectangle. 


If you turn the aspect feature off, the width-to-height ratio in the source 
rectangle changes as necessary to fill the destination rectangle fully. This may 
distort the source image. The following figure shows how a source image fills 
different destination rectangles when aspect is ”false” or ”true.” 


Effects of Overriding and Maintaining Image Aspect Ratios 





Destination Images Destination Images 
as pe ct= "false" as pect= "true" 
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TAG DESCRIPTIONS : J 
RealPix tags and attribute values create the RealPix timeline and 


visual effects. If you are familiar with HTML, you will master 
RealPix mark-up quickly. A typical RealPix tag looks like this: 


<fadein start="3” duration="1" target="1"/> 


Syntax Rules 
Keep the following points in mind when writing a RealPix file: 
- RealPix tags and attribute names must be lowercase. 
- A tag that does not have a corresponding end tag closes with a forward 
slash (/): 


<fadein.../> 


Only the <imfl> tag, which uses the end tag </imfl>, does not close with a 
slash. 


- Attribute values must be enclosed in double quotation marks. 


- Unless noted otherwise, the order of attributes following the tag name 
does not matter. 


- You can add a comment to a RealPix file like the following. Note that a 
comment tag does not require a closing slash: 


<!-- This is a comment --> 


Additional Information 
When you are familiar with the tags, you can use “Tag 
Summary” on page 58 as a quick reference. To learn 
more about Extensible Mark-up Language (XML), the 
language that RealPix is based on, visit 
http://www.w3.org/XML. 
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<imfl>...</imfl> 


<head/> 


All information in the file occurs between an opening <imfl> tag and a closing 
</imfl> tag. This is the only tag that uses an end tag. 


The <head/> tag follows the <imfl> tag in the RealPix file. Unlike the HTML 
<head> tag, the RealPix <head/> tag does not have a corresponding </head> tag. 
Instead, it ends with a slash: 


<head...attributes.../> 
The <head/> tag defines standard header information such as title, author, 


and copyright. It also sets necessary parameters such as the presentation 
duration and streaming bit rate. 


width and height 


These required attributes set the width of the display window in pixels. 
RealPlayer’s playback area expands to this size when the RealPix presentation 
begins. This example creates a RealPix playback area 256 by 256 pixels: 


<head width="256” height="256".../> 


When you play RealPix with another visual clip such as video, you lay out 
playback regions with SMIL. You typically create for RealPix a playback region 
that uses the same width and height you set here. If the region is a different 
size, the SMIL settings determine how to handle the size difference, such as by 
scaling or cropping the RealPix presentation to fit the display region. 


Additional Information 
Download RealSystem Production Guide from 
http://service.real.com/help/library/encoders.html 
for more on SMIL. 


timeformat 


This attribute sets the format the for start and duration times of RealPix 
effects. The default value is milliseconds, which means a time value such as 
5400 is read as 5400 milliseconds (5.4 seconds). Millisecond time values 
cannot include colons or a decimal point. 


You can also set the timeformat to the dd:hh:mm:ss.xyz format: 
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duration 


bitrate 


<head timeformat=“dd:hh:mm:ss.xyz”.../> 


Here, dd is days, hh is hours, mm is minutes, ss is seconds, x is tenths of 
seconds, y is hundredths of seconds, andz is milliseconds. Only the ss field is 
required. 


When the time value does not include a decimal point, the last field is read as 
the seconds. For example, 1:30 means 1 minute and 30 seconds, whereas 
1:30:00 means 1 hour and 30 minutes. Note that all the following values are 
equivalent. Each starts the effect 90 minutes after the RealPix presentation 
begins: 

start="1:30:00.0" 

start="90:00" 

start="5400" 


The required duration attribute sets the length of the entire RealPix 
presentation. For example, the following value sets a duration of 50 seconds: 


<head duration="50".../> 


All RealPix effects stop immediately when the duration elapses. When the 
duration time exceeds the time required to complete the effects, the last effect 
stays frozen in the display window. 


Tip 
Set a high duration when you start building a RealPix 
presentation. Set the final duration time when you have 


finished defining the effects. 


Additional Information 
SMIL mark-up also includes a duration setting that can 
stop the RealPix presentation even if its internal 
duration time has not elapsed. For more on this, 
download RealSystem Production Guide from 
http://service.real.com/help/library/encoders.html. 


The required bitrate attribute specifies the maximum bandwidth the 
presentation consumes. Specify the value in bits per second (bps). For 
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preroll 


example, the following value sets a maximum bandwidth of 12000 bps 
(approximately 12 Kbps): 
<head bitrate="12000".../> 


Additional Information 
“Bandwidth Usage” on page 51 explains how to calculate 
bandwidth requirements for a RealPix presentation. For 
information on dividing bandwidth between various 
media types in a presentation, see RealSystem Production 
Guide, available at http://service.real.com/help/ 
library/encoders.html. 


The optional preroll attribute specifies the time to buffer data in RealPlayer 
before the start of the RealPix presentation. For example, the following sets 
the RealPix preroll to 40 seconds: 


<head preroll="40".../> 


RealSystem always calculates the preroll required for the presentation based 
on the image file sizes and presentation timing parameters. If this calculated 
value is larger than the preroll you set, it overrides your specified preroll. Your 
preroll value is used, however, if it is higher than the calculated preroll value. 
You therefore need to set the preroll value only if you want an artificially high 
preroll. 


A high preroll can be useful when you stream RealPix with another clip. 
Suppose that a RealVideo clip starts midway through a RealPix presentation. 
You can use a high preroll to download a significant portion of the RealPix 
data before the presentation starts. The RealVideo clip then has more 
bandwidth available when it begins. It can therefore stream its required preroll 
without competing with RealPix for bandwidth. 


Tip 
Always balance preroll values with viewer expectations. 
Viewers may not stay tuned to a presentation that takes 
along time to start playing back. 


Additional Information 
For more on preroll, see Chapter 3 beginning on page 
Sl. 
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title, author, copyright 


These optional attributes define the title, author, and copyright information 
for the presentation: 
<head title="The Garden” 


author=“Jane Doe” 
copyright="(c) 1998 RealNetworks, Inc.”.../> 


When present, these attributes define the values that display in the RealPlayer 
information window and playlist (title only). If the RealPix presentation is 
played through a SMIL file, however, title, author, and copyright information 
set through SMIL may override the information you set here. 


Additional Information 


See the SMIL chapter in RealSystem Production Guide. 


background-color 


url 


The optional background-color attribute sets an initial background color. The 
default color is black. You can subsequently change the background color with 
the <fill/> tag. The following example sets the initial background color to a 
shade of red: 


<head background-color="#E00000”.../> 


Additional Information 
See “Colors” on page 45 for information on acceptable 
color values. 


This optional attribute sets a hyperlink URL for the presentation. When the 
user clicks a presentation image, the URL opens in the user’s default Web 
browser. Individual effects have their own URL settings that override this 
value. For the attribute value, use a fully qualified URL such as the following: 


<head url=“http://www.real.com”.../> 


Additional Information 
You can also use the url attribute to open a streaming 
presentation in a new RealPlayer window. See “Pop-Up 
Windows” on page 46 for more information. 
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aspect 


maxfps 


With its default value of “true”, the aspect attribute keeps a source rectangle’s 
height-to-width ratio constant when the destination rectangle has a different 
ratio. You can turn this off by setting the attribute to false: 


<head aspect="false”.../> 


In this case, the height-to-width ratio in the source rectangle changes as 
necessary to fill the destination rectangle fully. This may distort the source 
image. This aspect attribute in the <head/> tag affects the entire presentation. 
Individual effects can override this setting with their own aspect attributes, 
however. 


Additional Information 


See “Controlling Image Aspect” on page 16. 


This optional attribute sets the maximum frames per second (fps) for 
transition effects. It is not required because RealPlayer determines the optimal 
frame rate based on the playback computer’s available CPU power. When CPU 
power is plentiful, RealPlayer renders transition effects at the maximum of 30 
fps. It scales down the transition rates accordingly when less CPU power is 
available. 


You can set the maxfps attribute low to create special effects. For example, a 
value of 5: 


<head...maxfps="5"/> 


keeps transitions constrained to no more than 5 fps. This causes visible jerks 
in transitions, which may be a desirable effect. Additionally, you can use maxfps 
to balance CPU usage between multiple RealPix clips played simultaneously in 
a single SMIL presentation. 


Note 
Specify maxfps as the last attribute in the <head/> tag. 
The maxfps value affects the entire presentation, but 
individual effects can override it with their own maxfps 
values. 
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<image/> 


handle 


name 


size 


For each image you use in the RealPix presentation, you add an <image/> tag 
after the <head/> tag. The <image/> tag provides the image file location and 
assigns a unique handle number to the image. An <image/> tag looks like this: 


<image handle="2" name=“eagle.jpg”/> 


The required handle attribute assigns a positive integer to the image. Each 
handle number within the file must be unique. The RealPix effects then refer 
to the handle number rather than the file name. Here is an example: 


<image handle="23”.../> 


The name attribute is required. It specifies the image file name anda path 
relative to the location of the RealPix file on RealServer or the local machine. 
The following example designates an image file that resides in the same 
directory as the RealPix file: 


<image name=“tulip.jpg”.../> 


This next example indicates that the image file resides one level below the 
RealPix file in the “images” directory: 


<image name=“images/tulip.jpg”.../> 


Tip 
The file name and path are case sensitive. If you are 
streaming files from RealServer, folder (directory) 
names should not contain spaces. 


Additional Information 
The relative syntax for paths works like relative 
hyperlink syntax in HTML. You can find additional 
information about this topic in an HTML reference. 


The optional size attribute, which works only with RealPlayer 7 or later, 
specifies the size of the image in bytes. Include it in the <image/> tag when 
delivering a RealPix presentation with a Web server. RealPlayer can then 
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determine when to request each image clip from the Web server to ensure 
smooth playback. Here is an example of an image file approximately 24 KB in 
size: 

<image size="24000".../> 

The size attribute is not required when streaming a RealPix presentation from 
RealServer. In this case, RealServer determines the image sizes by opening the 


files. It then calculates when to stream each image to ensure smooth playback 
for the viewer’s given bandwidth. 


Note 
Be careful to list the file sizes correctly. If the file is 
significantly larger than the value given by its size 
attribute, the presentation may stall. 


mime 


The optional mime attribute works with RealPlayer 7 and later. It specifies the 
image mime type, and may be necessary when delivering a RealPix 
presentation with a Web server. Here is an example: 


<image mime=“image/jpeg”.../> 

The following are the valid mime types you can use: 

GIF images: mime=“image/gif” 

JPEG images: mime=“image/jpeg” 

PNG images: mime= “image/png” 

RealSystem typically determines the mime type from the image file’s 


extension, such as .gif or .jpg, making the mime attribute unnecessary. You 
need to include the mime attribute only on these two conditions: 


+ <image/> tags use the size attribute 
—and— 


- the <image/> tag’s name attribute gives a file name that does not include a 
file extension. 


<fill/> 


The <fill/> tag displays a colored rectangle in the display window. This is 
useful at the beginning of a presentation or anytime you want to paint over all 
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or part of the display window. You can fade in an image, for instance, then fill 
the display window with black to paint over the image. A <fill/> tag looks like 
this: 


<fill start="0" color="blue”/> 


start 


The start attribute is required. It specifies the time from the beginning of the 
RealPix timeline that the fill occurs. The following example starts the fill 2.3 
seconds into the presentation timeline: 


<fill start="2.3".../> 


Additional Information 
For information on the time format, see the <head/> tag 
timeformat attribute on page 19. 


color 
This required attribute sets the fill color. You can use a predefined color name 
or a hexadecimal value as illustrated here: 


<fill color="#FF0000”.../> 


Additional Information 
For more on color values and names, see “Colors” on 
page 45. 


dstx, dsty, dstw, dsth 


These optional attributes define the size and placement of the filled region. 
Leave them out to fill the entire display window. To fill only a portion of the 
display window, set the destination rectangle’s x and y coordinates, as well as 
its height and width in pixels: 


dstx  X coordinate of the destination rectangle. 
dsty § Y coordinate of the destination rectangle. 
dstw Width of the destination rectangle. 


dsth Height of the destination rectangle. 


Here’s an example that fills a rectangle 128 by 128 pixels. The filled region 
appears 92 pixels to the right of the main window’s left edge and 64 pixels 
down from its top edge 
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<fill dstx="92" dsty="64" dstw="128”" dsth="128".../> 


Additional Information 
For more on the sizes and offsets of source and 
destination rectangles, see “Controlling Image Size, 
Placement, and Aspect” on page 13. 


<fadein/> 


The <fadein/> tag creates a gradual transition from the currently displayed 
color or image to another image. A <fadein/> tag looks like this: 


<fadein start="4" duration="3" target="2"/> 
The following figure illustrates a fade-in from a solid color to an image. 


Fade-in from a Solid Color to an Image 

















Tip 
You can fade in multiple images simultaneously. 
RealNetworks recommends that these images do not 
overlap, however, because the appearance of overlapping 
areas may vary. 


start 


The start attribute is required. It specifies the time from the beginning of the 
RealPix timeline that the fade-in occurs. Here is an example that starts the 
fade-in 4 seconds into the timeline: 


<fadein start="4".../> 


Additional Information 
For information on the time format, see the <head/> tag 
timeformat attribute on page 19. 
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duration 


This required attribute specifies the total time for the effect to complete. The 
higher the value, the slower the fade-in. For example, the following value 
means the fade-in takes 2.5 seconds to complete: 


<fadein duration="2.5".../> 


target 
The target attribute is required. It specifies the <image/> tag handle (see page 
24) of the image to fade in. For example: 
<fadein target="2".../> 

dstx, dsty, dstw, dsth 


These optional attributes define the size and placement of the image that 
fades in. Leave them out to fade the image into the entire display window.To 
fade the image into a portion of the display window, set the destination 
rectangle’s x and y coordinates, as well as its height and width in pixels: 


dstx _X coordinate of the destination rectangle. 
dsty § Y coordinate of the destination rectangle. 
dstw Width of the destination rectangle. 


dsth Height of the destination rectangle. 


Tip 
You can fade in different images into parts of the display 
window simultaneously. RealNetworks recommends 
that the destination rectangles do not overlap, however, 
because the appearance of overlapping areas may vary. 


The following example fades the image into a rectangle 128 by 128 pixels. The 
image displays 20 pixels to the right of the main window’s left edge and 40 
pixels down from its top edge: 


<fadein dstx="20" dsty="40" dstw=“128” dsth="128”.../> 


Additional Information 
For more on the sizes and offsets of source and 
destination rectangles, see “Controlling Image Size, 
Placement, and Aspect” on page 13. 
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srcx, srcy, srcw, srch 


url 


aspect 


These four attributes define what portion of the source image fades into the 
destination rectangle. Leave them out to fade the entire source image into the 
destination rectangle. To use only a portion of the source image, set the source 
rectangle’s x and y coordinates, as well as its height and width in pixels. 


Srcx X coordinate of the source rectangle. 
srcy Y coordinate of the source rectangle. 
srcw Width of the source rectangle. 


srch Height of the source rectangle. 


The following example selects from the source image a source rectangle 128 
pixels wide by 256 pixels high. The source rectangle starts 64 pixels to the 
right of the source image’s left edge and 92 pixels down from its top edge: 


<fadein srcx="64" srcy="92" srcw="128" srch="256".../> 


Additional Information 
For more on the sizes and offsets of source and 
destination rectangles, see “Controlling Image Size, 
Placement, and Aspect” on page 13. 


This optional attribute sets a hyperlink URL for the effect. When the user 
clicks the image, the user’s default Web browser opens the URL. This URL 
value overrides the presentation default set in the <head/> tag (see page 22) for 
the remainder of the presentation, or until another url attribute sets a 
different url. Use a fully qualified URL like the following: 


<fadein url=“http://www.real.com”.../> 


Additional Information 
You can also use the url attribute to open a streaming 
presentation in a new RealPlayer window. See “Pop-Up 
Windows” on page 46 for more information. 


This optional attribute determines whether the source rectangle’s height-to- 
width ratio is maintained when the destination rectangle has a different 
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maxfps 


<fadeout/> 


start 


height-to-width ratio. The presentation’s default value is set in the <head/> tag 
(see page 23), but you can override it for the fade-in: 


<fadein aspect=“false”.../> 


This optional attribute sets the maximum frames per second for the effect. It 
overrides any default maxfps value set in the <head/> tag (see page 23). Include 
it as the last attribute. Here’s an example: 


<fadein...maxfps="5"/> 


The <fadeout/> tag defines a transition from an image to a color. The basic 
<fadeout/> tag looks like this: 


<fadeout start="10" duration="3" color=“yellow’/> 


The following figure illustrates a fade-out. 


Fade-out from an Image to a Solid Color 





The start attribute is required. It specifies the time from the beginning of the 
RealPix timeline that the fade-out occurs. The following example starts the 
fade-out 10 seconds into the presentation: 


<fadeout start="10".../> 
Additional Information 


For information on the time format, see the <head/> tag 
timeformat attribute on page 19. 
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duration 


color 


This required attribute specifies the total time the effect takes to complete. 
The higher the value, the slower the fade-out. For example, the following 
makes the fade-out last 3.75 seconds: 


<fadeout duration="3.75".../> 


This required attribute sets the color the image fades to. You can use a 
hexadecimal value or a predefined color name as illustrated here: 


<fadeout color=“blue”.../> 


Additional Information 
For more on color values and names, see “Colors” on 
page 45. 


dstx, dsty, dstw, dsth 


These optional attributes define the size and placement of the rectangle that 
fades out. Leave them out of the tag to fade out the entire display window. To 
fade out only a portion of the display window, set the destination rectangle’s x 
and y coordinates, as well as its height and width in pixels: 


dstx _X coordinate of the destination rectangle. 
dsty | Y coordinate of the destination rectangle. 
dstw Width of the destination rectangle. 


dsth Height of the destination rectangle. 


Tip 
You can fade out different parts of the display window 
simultaneously. RealNetworks recommends that the 
destination rectangles do not overlap, however, because 
the appearance of overlapping areas may vary. 


The following example fades out a rectangle 64 pixels wide by 64 pixels high. 
The rectangle starts 110 pixels to the right of the main window’s left edge and 
80 pixels down from its top edge: 


<fadeout dstx="110" dsty="80" dstw="64" dsth="64".../> 
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Additional Information 
For more on the sizes and offsets of source and 
destination rectangles, see “Controlling Image Size, 
Placement, and Aspect” on page 13. 


maxfps 


This optional attribute sets the maximum frames per second for the effect. It 
overrides any default maxfps value set in the <head/> tag (see page 23). Include 
it as the last attribute. Here’s an example: 


<fadeout...maxfps="5"/> 


<crossfade/> 


The <crossfade/> tag creates a transition from one image to another, as 
illustrated in the following figure. 


Crossfade from One Image to Another 





start 


The start attribute is required. It specifies the time from the beginning of the 
RealPix timeline that the crossfade occurs. Here is an example that starts the 
effect 12.3 seconds into the timeline: 


<crossfade start="12.3".../> 


Additional Information 
For information on the time format, see the <head/> tag 
timeformat attribute on page 19. 
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duration 


This required attribute specifies the total time the effect takes to complete. 
The higher the value, the slower the crossfade. For example, the following 
makes the crossfade take just 1.5 seconds to complete: 


<crossfade duration="1.5".../> 


target 
The target attribute is required. It specifies the <image/> tag handle (see page 
24) of the image to fade in. For example: 
<crossfade target="2".../> 

dstx, dsty, dstw, dsth 


These optional attributes define the size and placement of the image that 
fades in. Leave them out to fade the image into the entire display window.To 
fade the image into a portion of the display window, set the destination 
rectangle’s x and y coordinates, as well as its height and width in pixels: 


dstx _X coordinate of the destination rectangle. 
dsty § Y coordinate of the destination rectangle. 
dstw Width of the destination rectangle. 


dsth Height of the destination rectangle. 


Tip 
You can crossfade different parts of the display window 
simultaneously. RealNetworks recommends that the 
destination rectangles do not overlap, however, because 
the appearance of overlapping areas may vary. 


The following example fades the image into a rectangle 128 by 128 pixels. The 
image displays 20 pixels to the right of the main window’s left edge and 40 
pixels down from its top edge: 


<crossfade dstx="20" dsty="40" dstw="128" dsth="128".../> 


Additional Information 
For more on the sizes and offsets of source and 
destination rectangles, see “Controlling Image Size, 
Placement, and Aspect” on page 13. 
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srcx, srcy, srcw, srch 


url 


aspect 


These four attributes define what portion of the source image fades into the 
destination rectangle. Leave them out to fade the entire source image into the 
destination rectangle. To use only a portion of the source image, set the source 
rectangle’s x and y coordinates, as well as its height and width in pixels. 


Srcx X coordinate of the source rectangle. 
srcy Y coordinate of the source rectangle. 
srcw Width of the source rectangle. 


srch Height of the source rectangle. 


The following example selects from the source image a source rectangle 128 
pixels wide by 256 pixels high. The source rectangle starts 64 pixels to the 
right of the source image’s left edge and 92 pixels down from its top edge: 


<crossfade srcx="64" srcy="92" srcw="128" srch="256".../> 


Additional Information 
For more on the sizes and offsets of source and 
destination rectangles, see “Controlling Image Size, 
Placement, and Aspect” on page 13. 


This optional attribute sets a hyperlink URL for the effect. When the user 
clicks the image, the user’s default Web browser opens the URL. This URL 
value overrides the presentation default set in the <head/> tag (see page 22) for 
the remainder of the presentation, or until another url attribute sets a 
different url. Use a fully qualified URL like the following: 


<crossfade url="http://www.real.com”.../> 


Additional Information 
You can also use the url attribute to open a streaming 
presentation in a new RealPlayer window. See “Pop-Up 
Windows” on page 46 for more information. 


This optional attribute determines whether the source rectangle’s height-to- 
width ratio is maintained when the destination rectangle has a different 
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maxfps 


<animate/> 


start 


height-to-width ratio. The presentation’s default value is set in the <head/> tag 
(see page 23), but you can override it for the crossfade: 


<crossfade aspect="false”.../> 


This optional attribute sets the maximum frames per second for the effect. It 
overrides any default maxfps value set in the <head/> tag (see page 23). Include 
it as the last attribute. Here’s an example: 


<crossfade...maxfps="5"/> 


The <animate/> tag starts an animated GIF cycling through its frames, 
specifying how long it animates. An <animate/> tag looks like this: 


<animate start="10" duration="30" target="2"/> 


If you introduce an animated GIF into the presentation with <animate/>, the 
GIF appears instantly at its start time, with no transition effect. However, you 
can also introduce the GIF with another tag, such as <fadein/>, then use 
<animate/> to start the animation. Here’s an example: 


<fadein start="5" duration="1" target="2”"/> 
<animate start="10" duration="30" target="2"/> 


In this example, the animated GIF fades in at five seconds into the timeline. 
Its first frame remains stationary until 10 seconds into the timeline. The GIF 
then cycles through its preprogrammed animation sequence for 30 seconds. 


The start attribute is required. It specifies the time from the beginning of the 
RealPix timeline that the animated GIF begins to animate. For example, the 
following makes the GIF start to animate 14 seconds into the timeline: 


<animate start="14".../> 
Additional Information 


For information on the time format, see the <head/> tag 
timeformat attribute on page 19. 
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duration 


This required attribute specifies the total time that the GIF animates. For 
example, the following value means the GIF animates for 60 seconds, 
completing as many animation cycles as possible within that time: 


<animate duration="60".../> 


If the GIF still displays in the RealPlayer window after its duration time 


elapses, the last frame shown before the duration time elapsed appears frozen 
on the screen. 


Note 
The <head/> tag’s duration time overrides the GIF's 
duration. So if you set the GIF to animate for five 
minutes, but the presentation duration is four minutes, 
the GIF stops animating at the four-minute mark. 


target 
The target attribute is required. It specifies the <image/> tag handle (see page 
24) of the GIF image to animate. For example: 
<animate target="2".../> 

dstx, dsty, dstw, dsth 


These optional attributes define the size and placement of the GIF image 
within the RealPlayer display window. Leave them out to have the GIF image 
fill the entire window.To fill just a portion of the display window, set the 
destination rectangle’s x and y coordinates, as well as its height and width in 
pixels: 

dstx  X coordinate of the destination rectangle. 

dsty  Y coordinate of the destination rectangle. 

dstw Width of the destination rectangle. 


dsth Height of the destination rectangle. 


Tip 
You can display different GIF images in different parts 
of the display window simultaneously. RealNetworks 
recommends that the destination rectangles do not 





36 


RealPix Authoring Guide CHAPTER 2: Tag Descriptions 





overlap, however, because the appearance of overlapping 
areas may vaty. 


The following example displays the GIF image at 468 by 60 pixels. The image 
displays 5 pixels to the right of the main window’s left edge and 10 pixels 
down from its top edge: 


<animate dstx="5" dsty="10" dstw="468" dsth="60".../> 


Additional Information 
For more on the sizes and offsets of source and 
destination rectangles, see “Controlling Image Size, 
Placement, and Aspect” on page 13. 


srcx, srcy, srcw, srch 


These four attributes define what portion of the source GIF appears in the 
destination rectangle. Leave them out to display the entire source image in the 
destination rectangle. To use only a portion of the source image, set the source 
rectangle’s x and y coordinates, as well as its height and width in pixels. 


srcx X coordinate of the source rectangle. 
srcy _ Y coordinate of the source rectangle. 
srcw Width of the source rectangle. 


srch Height of the source rectangle. 


The following example selects from the source GIF a source rectangle 234 
pixels wide by 58 pixels high. The source rectangle starts 117 pixels to the right 
of the source image’s left edge and 1 pixel down from its top edge: 


<animate srcx="117" srcy="1" srcw="234" srch=“58".../> 


Additional Information 
For more on the sizes and offsets of source and 
destination rectangles, see “Controlling Image Size, 
Placement, and Aspect” on page 13. 


url 


This optional attribute sets a hyperlink URL for the animated GIF. When the 
user clicks the image, the user’s default Web browser opens the URL. This 
URL value overrides the presentation default set in the <head/> tag (see page 
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22) for the remainder of the presentation, or until another url attribute sets a 
different url. Use a fully qualified URL like the following: 


<animate url=“http://www.real.com”.../> 
Additional Information 
You can also use the url attribute to open a streaming 


presentation in a new RealPlayer window. See “Pop-Up 
Windows” on page 46 for more information. 


aspect 


This optional attribute determines whether the source rectangle’s height-to- 
width ratio is maintained when the destination rectangle has a different 
height-to-width ratio. The presentation’s default value is set in the <head/> tag 
(see page 23), but you can override it for the GIF: 


<animate aspect="false”.../> 


maxfps 


This optional attribute sets the maximum frames per second for the GIF 
animations. It overrides any default maxfps value set in the <head/> tag (see 
page 23). Include it as the last attribute. Here’s an example: 


<animate...maxfps="1"/> 


<wipe/> 


The <wipe/> tag creates a transition from one image to another, either by 
covering the displayed image or by pushing it out of the way with a sliding 
effect. A typical <wipe/> tag looks like this: 


<wipe type="push” direction="left” start="10" duration="3”" target="2"/> 


The following figure illustrates this effect. 


“Push” Wipe Transition from One Image to Another 
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start 


The start attribute is required. It specifies the time from the beginning of the 
Real Pix timeline that the wipe occurs. Here is an example that starts the effect 
30 seconds into the presentation: 


<wipe start="30".../> 
Additional Information 


For information on the time format, see the <head/> tag 
timeformat attribute on page 19. 


duration 


This required attribute specifies the total time the effect takes to complete. 
The higher the value, the slower the transition. For example, the following 
makes the wipe take 5.5 seconds to complete: 


<wipe duration="5.5".../> 


target 


The target value is required. It specifies the <image/> tag handle of the image 
(see page 24) to bring in with the wipe effect. For example: 


<wipe target="2".../> 


type 


This required attribute defines the type of transition that occurs: 


normal New image moves over current image, which remains 
stationary. 


push New image pushes current image out (both images move). 


Here is an example: 


<wipe type="push”.../> 


direction 
This required attribute sets the direction the new image moves: 


left New image starts at right edge, moves toward left edge. 


right New image starts at left edge, moves toward right edge. 
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up New image starts at bottom edge, moves toward top edge. 


down New image starts at top edge, moves toward bottom edge. 


For example: 


<wipe direction=“up”.../> 


dstx, dsty, dstw, dsth 


These optional attributes define the size and placement of the image that 
moves in. Leave them out to move the image into the entire display window. 
To move the image into a portion of the display window, set the destination 
rectangle’s x and y coordinates, as well as its height and width in pixels: 


dstx. _X coordinate of the destination rectangle. 
dsty § Y coordinate of the destination rectangle. 
dstw Width of the destination rectangle. 
dsth Height of the destination rectangle. 


Tip 
You can wipe different parts of the display window 
simultaneously. RealNetworks recommends that the 
destination rectangles do not overlap, however, because 
the appearance of overlapping areas may vary. 


The following example moves the image into a rectangle 64 by 64 pixels. The 
image displays 50 pixels to the right of the main window’s left edge and 70 
pixels down from its top edge: 


<wipe dstx="50" dsty="70" dstw="64”" dsth="64".../> 
Additional Information 
For more on the sizes and offsets of source and 


destination rectangles, see “Controlling Image Size, 
Placement, and Aspect” on page 13. 


srcx, srcy, srcw, srch 


These four attributes define what portion of the source image moves into the 
display rectangle. Leave them out to move the entire source image into the 
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url 


aspect 


destination rectangle. To use a portion of the source image, set the source 
rectangle’s x and y coordinates, as well as its height and width in pixels. 


Srcx X coordinate of the source rectangle. 
srcy _Y coordinate of the source rectangle. 
srcw Width of the source rectangle. 


srch Height of the source rectangle. 


The following example selects from the source image a source rectangle 128 
pixels wide by 128 pixels high. The source rectangle starts 89 pixels to the 
right of the source image’s left edge and 115 pixels down from its top edge: 


<wipe srcx="89”" srcy="115" srcw="128" srch="128".../> 


Additional Information 
For more on the sizes and offsets of source and 
destination rectangles, see “Controlling Image Size, 
Placement, and Aspect” on page 13. 


This optional attribute sets a hyperlink URL for the new image. When the user 
clicks the image, the user’s default Web browser opens the URL. This URL 
value overrides the presentation default set in the <head/> tag (see page 22) for 
the remainder of the presentation, or until another url attribute sets a 
different url. Use a fully qualified URL like the following: 


<wipe url=“http://www.real.com”.../> 


Additional Information 
You can also use the url attribute to open a streaming 
presentation in a new RealPlayer window. See “Pop-Up 
Windows” on page 46 for more information. 


This optional attribute determines whether the source rectangle’s height-to- 
width ratio is maintained when the destination rectangle has a different 
height-to-width ratio. The presentation’s default value is set in the <head/> tag 
(see page 23), but you can override it for the wipe effect: 


<wipe aspect="false”.../> 
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maxfps 


This optional attribute sets the maximum frames per second for the effect. It 
overrides any default maxfps value set in the <head/> tag (see page 23). Include 
it as the last attribute. Here’s an example: 


<wipe...maxfps="5"/> 


<viewchange/> 


start 


duration 


The <viewchange/> tag defines a pan or a zoom. A typical <viewchange/> tag 
looks like this: 


<viewchange start="24" duration="3”" srcx="80" srcy="80" srcw="48" srch="48"/> 


Note that <viewchange/> does not specify an image. The view change always 
affects the image currently in the display window. The following figure 
illustrates a zoom created with a <viewchange/> tag. 


Zoom Effect Created with a View Change 





The start attribute is required. It specifies the time from the beginning of the 
RealPix timeline that the view change occurs. The following example starts the 
effect 35.2 seconds into the presentation timeline: 


<viewchange start="35.2".../> 


Additional Information 
For information on the time format, see the <head/> tag 
timeformat attribute on page 19. 


This required attribute specifies the total time the effect takes to complete. 
The higher the value, the slower the pan or zoom. For example, the following 
makes the transition take 8 seconds to complete: 
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<viewchange duration="8".../> 


dstx, dsty, dstw, dsth 


These four attributes define in pixels the placement and size of the 
destination rectangle. See below for more information. 

dstx  X coordinate of the destination rectangle. 

dsty § Y coordinate of the destination rectangle. 

dstw Width of the destination rectangle. 

dsth = Height of the destination rectangle. 


srcx, srcy, srcw, srch 


These four attributes define in pixels the placement and size of the source 
image. See below for more information. 

Srcx X coordinate of the source rectangle. 

srcy _Y coordinate of the source rectangle. 

srcw Width of the source rectangle. 


srch Height of the source rectangle. 


maxfps 


This optional attribute sets the maximum frames per second for the effect. It 
overrides any default maxfps value set in the <head/> tag (see page 23). Include 
it as the last attribute. Here’s an example: 


<viewchange...maxfps="5"/> 


Zooming in on an Image 


To zoom in on an image, display the image and then use <viewchange/> to 
define the area to zoom in on. The following example is taken from a RealPix 
presentation that displays in a window 256 by 256 pixels. The source image is 
also 256 by 256 pixels. The presentation fades in on the image and then zooms 
in, taking three seconds to complete the zoom: 

<fadein start="1" duration="2” target="1"/> 

<viewchange start="4" duration="3” srcx="64" srcy="64" srcw="128" srch="128"/> 
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The zoom selects an area 128 by 128 pixels square in the center of the source 
image. This square displays in the full 256 by 256 pixel display window. The 
following figure illustrates this zoom. 


Zooming in on Part of an Image 


256 


256 





source destination 


Because this zoom effect does not specify a destination rectangle, the zoom 
image fills the entire display window. But you can also use the destination 
coordinates (dstx, dsty, dstw, dsth) to specify a portion of the display window. 


Panning across an Image 


To pan across an image, you display a portion of the source image, then use 
<viewchange/> to move to a different part of the source image. The following 
example uses a RealPix presentation that displays in a window 256 by 256 
pixels. The source image is also 256 by 256 pixels: 

<fadein start="1" duration="3" target="2"/> 

<viewchange start="4" duration="3” srcx="0" srcy="0" srcw="128" srch="128"/> 
<viewchange start="7" duration="3" srcx="128" srcy="0" srcw="128" srch="128"/> 


The presentation fades in an image, zooms in on the upper left-hand 
quadrant, then pans to the upper, right-hand quadrant. Each effect takes 
three seconds to complete. The following figure illustrates this movement. 
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Zooming in on, then Panning across an Image 





SOurce destination 


Because this pan effect does not specify a destination rectangle, the source 
rectangle fills the entire display window. But you can also use the destination 
coordinates (dstx, dsty, dstw, dsth) to specify a portion of the display window. 


Colors 


RealPix effects that use colors can specify a 24-bit, hexadecimal color value. 
These are the same color values as those used in HTML. The first two hex 
digits represent red, the next two green, and the last two blue. For example, 
“#FF8000" indicates the 24-bit RGB color 255:128:0. Alternately, RealPix color 
attributes can use the predefined names shown below. 
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white (#FFFFFF) silver (HCOCOCO) gray (#808080) black (#000000) 
yellow (#FFFFOO) fuchsia (#FFOOFF) red (#FFO000) maroon (#800000) 
lime (#00FFOO) olive (#808000) green (#008000) purple (#800080) 
aqua (#OOFFFF) teal (#008080) blue (#O0000FF) navy (#000080) 


Transparency 


Transparent areas in GIF and PNG images show underlying images or 
background colors within RealPix. Transparency is not maintained between 
regions in a SMIL presentation, though. Ifa RealPix clip is in front of a video 
clip in a SMIL presentation, for example, the underlying video region will not 
show through the image transparency in the RealPix region. For more on 
SMIL, download RealSystem Production Guide from 
http://service.real.com/help/library/encoders.html. 


Pop-Up Windows 


Through the RealPix url attributes, you can open streaming presentations in 
new RealPlayer windows. RealPlayer 7 or higher (but not RealPlayer G2) can 
open as many player windows as the computer CPU and memory allow. A 
RealPix hyperlink that opens a new RealPlayer window uses this format: 


url=“command:openwindow(name, URL, playmode=value, ...)” 


When a viewer clicks a link with this syntax, command:openwindow tells 
RealPlayer to open a new window for the given URL, and stop the presentation 
in the current window. This command requires two arguments, name and URL. 
The playmode arguments are optional. You can separate arguments with a 
comma, but this is not required. A space may precede or follow a comma. If an 
argument contains characters such as commas or parentheses, enclose it in 
single quotation marks. 


Tip 
Because RealPlayer G2 does not support multiple 
windows, make sure your users know RealPlayer 7 or 
higher is required. RealSystem Production Guide contains 
information on using a SMIL <switch> tag to support 
both RealPlayer 7 (or higher) and RealPlayer G2. 
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name 


URL 


The mandatory name argument comes first. It supplies a predefined or user- 
defined name for the new RealPlayer window. The following table gives the 
values for the name argument. 


name Argument 


Name Function 





_new or | Opens anew RealPlayer window each time the viewer clicks the link. Each 
_blank subsequent link named _new or _blank opens a new window as well. 





_self or | Opens the URL in the current RealPlayer window. 
_ current 





name Creates a new RealPlayer window with the user-defined name. A 
subsequent openwindow command using the same name opens the given 
URL in the same window. 








Following the name argument, the required URL argument gives the fully 
qualified URL to the clip or SMIL presentation. You must include the 
protocol, such as rtsp://, http://, chttp://, or file:// in the URL. Relative URLs 
do not work. 


playmode 


The optional playmode=value argument defines the state of the new RealPlayer 
window that opens. A command to open a new window can have more than 
one playmode argument. The following table gives the possible values for 
playmode. 


playmode Attributes and Values 


Attribute Value Function 





true Puts window in autosize mode so that it minimizes to just 
the display window when the cursor is not over it. 





false Opens window in compact mode so that it does not change 
size on a mouseover. This is the default. Note that normal 
view mode is available only on the main RealPlayer window, 
not the pop-up windows. 


autosize 











(Table Page 1 of 2) 
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playmode Attributes and Values (continued) 




















Attribute Value Function 
normal | Plays clip at its normal encoded size. This is the default. 
double | Doubles clip size. 
zoomlevel 
full Plays clip at full-screen. If the operating system does not 
support full-screen zoom, normal mode is used instead. 

_ | true Keeps window on top of other windows on the desktop. 
ontopwhile ; - ; a 
playi false Lets user determine which windows to place on top. This is 

ying 
the default. 


(Table Page 2 of 2) 


Examples of Opening New RealPlayer Windows 


The following sections provide examples of how to create hyperlinks that 
launch new RealPlayer windows. 


Targeting the Same Window with Multiple Links 
The following RealPix link opens a URL in a new RealPlayer window named 


feature. The new window is set to autosize mode: 


url="command:openwindow(feature, rtsp://realserver.example.com/comedy.rm, 
autosize=true)” 


When first clicked, this link creates a RealPlayer window named feature. If 
another link also targets the feature window, clicking that link starts the new 
URL in the feature window. Clicking the following link, for example, starts an 
animal program in the window running the comedy program. This link 
switches the window out of autosize mode, though: 


url="command:openwindow(feature, rtsp://realserver.example.com/animals.rm, 
autosize=false)” 


Opening Separate Windows 


Each link opens a separate window if the window names are different, or you 
use the predefined name _new or _blank. The following links open separate 
autosizing windows that play on top of all other desktop windows: 


url="command:openwindow(_new, rtsp://realserver.example.com/comedy.rm, 
autosize=true, ontopwhileplaying=true)” 


url="command:openwindow(_blank, rtsp://realserver.example.com/animals.rm, 
autosize=true, ontopwhileplaying=true)” 
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Launching URLs in the Current Window 
Use either _current or _self to open the URL in the current window: 


url="command:openwindow(_current, rtsp://realserver.example.com/animals.rm)” 


The next link plays the clip at double its encoded size: 


url="command:openwindow(_self, rtsp://realserver.example.com/comedy.rm, 
zoomlevel=double)” 


Example Presentation 


The following example file demonstrates the RealPix mark-up. To play this 
and other examples in RealPlayer, download the HTML version of this manual 
from http://service.real.com/help/library/encoders.html. 


<imfl> 

<head title=“RealPix(tm) Sample Effects” 
author=“Jay Slagle” 
copyright="(c)1998 RealNetworks, Inc.” 
timeformat=“dd:hh:mm:ss.xyz” 
duration="46” 
bitrate="12000" 
width="256" 
height="256" 
url=“http://www.real.com” 
aspect="true”/> 


<!-- Assign handle numbers to images --/> 
<image handle="1" name="jbeans.jpg”/> 
<image handle="2" name="peppers.jpg”/> 
<image handle="3" name="elephant.jpg”/> 
<image handle="4" name="hippo.jpg”/> 
<image handle="5" name="interior.jpg”/> 

<!-- Fade in and crossfade images --/> 

<fill start="0" color=“black”/> 

<fadein start="1" duration="2”" target="1"/> 
<crossfade start="4" duration="3” target="2"/> 


<!-- Fade out with expanding squares --/> 


<fadeout start="8" duration="1" color=“lime” 
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dstx="96" dsty="96" dstw="64" dsth="64”/> 
<fadeout start="9" duration="1" color="“green” 
dstx="64" dsty="64" dstw="128" dsth="128"/> 
<fadeout start="10" duration="1" color="#6D8073" 
dstx="32”" dsty="32" dstw="192” dsth="192”/> 
<fadeout start="11" duration="1" color="black” 
dstx="0" dsty="0" dstw="256" dsth="256"/> 


<!-- Wipe in checkerboard images --/> 


<fadein start="13" duration="3" target="3"/> 
<wipe type="push” direction=“left” start="16" 
duration="3” target="4" 
srcx="0" srcy="0" srcw="128" srch="128" 
dstx="0" dsty="0" dstw="128" dsth="128"/> 
<wipe type=“push” direction=“right” start="19” 
duration="3” target="4" 
srcx="128" srcy="128" srcw="128" srch="128" 
dstx="128" dsty="128" dstw="128" dsth="128"/> 
<wipe type=“push” direction=“up” start="22” 
duration="3”" target="4" 
srcx="0" srcy="128" srcw="128" srch="128" 
dstx="0" dsty="128" dstw="128" dsth="128"/> 
<wipe type=“push” direction=“down” start="25" 
duration="3”" target="4" 
srcx="128" srcy="0" srcw="128" srch="128" 
dstx="128" dsty="0" dstw="128" dsth="128"/> 


<!-- Zoom in and pan --/> 


<fadein start="29" duration="3" target="5"/> 
<viewchange start="32" duration="3" 
srcx="0" srcy="0" srcw="160" srch="160"/> 
<viewchange start="35.5" duration="3" 
srcx="96" srcy="0" srcw="160" srch="160"/> 
<viewchange start="39" duration="3" 
srcx="96" srcy="96" srcw="160" srch="160"/> 
<viewchange start="42.5" duration="3" 
srcx="0" srcy="96" srcw="160" srch="160"/> 
</imfl> 
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When you stream your RealPix presentation to viewers over a 
network such as the World Wide Web, you need to consider the 
bandwidth (bit rate) the presentation will consume. You don’t need 
to consider bandwidth if copies of the presentation files will reside 
on each viewer’s desktop computer, however. This section helps you 


determine your presentation’s bandwidth usage. It also gives tips for 
lowering bandwidth consumption. 





BANDWIDTH USAGE 


Additional Information 
For an explanation of bandwidth in RealSystem, see 
RealSystem Production Guide available at 
http://service.real.com/help/library/encoders.html. 


Targeting a Bit Rate 


The following table lists the recommended maximum presentation bit rate for 
streaming files over different network connections. If you want to reach users 
with 28.8 Kbps modems, for example, your presentation should not consume 
more than 20 Kilobits of data per second. The full 28.8 Kbps is not available 
because bandwidth is required for noise, data loss, and packet overhead. 


Bit Rates Available for Streaming Files 


Suggested Maximum Bit 
Target Connection Speed _ Rate for Streaming Files 














14.4 Kbps modem 10 Kbps 
28.8 Kbps modem 20 Kbps 
56.0 Kbps modem 34 Kbps 
56.0 Kbps ISDN 45 Kbps 
112 KbpsdualISDN _80 Kbps 
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You also need to consider bandwidth required by other clips in the 
presentation. If you target 28.8 Kbps modem connections, for example, and 
your presentation has a RealAudio soundtrack that consumes 5 Kbps, you 
have 15 Kbps left for RealPix. You should set this value in the <head/> tag 
bitrate attribute (see page 20). This tells RealServer your target bandwidth 
value. 


The bandwidth your presentation actually requires, however, depends on the 
total size of the image files and the presentation length. To get a rough 
estimate of this bandwidth, add together the sizes of all image files used in the 
presentation. Convert this total to Kilobits using the chart below. Then divide 
by the RealPix presentation length in seconds. 


Converting File Size to Kilobits 











Using This Measurement Do This to Get Kilobits 
Megabytes Multiply by 8192 
Kilobytes Multiply by 8 

bytes Divide by 128 

bits Divide by 1024 





For example, if your image files add up to 200 Kilobytes, multiply 200 by 8 to 
get 1600 Kilobits. A presentation that lasts two minutes, for instance, uses an 
average of 13.3 Kilobits per second: 


(200 Kilobytes x 8)/120 seconds = 13.3 Kilobits per second 


If your RealPix target is 15 Kbps, your presentation should stream smoothly 
with bandwidth to spare. 


This simple estimate assumes that all images are each about the same size and 
are streamed at regular intervals. You run into bandwidth problems, however, 
if you use a lot of images near the start of the presentation. If the presentation 
begins by fading four big images into four quadrants of the display window, 
for example, RealServer needs to download a lot of image data before the 
presentation can begin. This results in a lengthy preroll. 


What is Preroll? 


Before it delivers a RealPix presentation, RealServer looks at the image sizes 
and the presentation timeline. Weighing these against the bit rate set in the 
<head/> tag (see page 20), RealServer determines how much data RealPlayer 
must receive before it can start to play the presentation. This ensures that once 
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RealPlayer commences playback, it does not need to halt the presentation 
while it receives more data. The initial data sent before playback is the preroll. 
As a general rule, you want the preroll under 15 seconds, ideally under 10 
seconds. 


For example, if a RealPix presentation streams for 60 seconds at 20 Kbps, it 
can deliver up to 1200 Kb of data during playback. If the RealPix presentation 
requires 1400 Kb of data, at least 200 Kb of data must be sent as preroll. At 20 
Kbps, this equals a 10 second preroll: 


(1400 Kb - 1200 Kb)/20 Kbps = 10 seconds 


As mentioned above, presentation size divided by presentation length is only a 
rough guide to preroll length. RealServer considers when each image is 
introduced in the timeline when it calculates preroll. The following sections 
give instructions for determining preroll more accurately and for reducing 
bandwidth consumption. 


Calculating Bandwidth Use 


The RealPix Bandwidth Calculator (rpcale.xls) is a Microsoft Excel 97 for 
Windows spreadsheet included in the utils directory of the HTML version of 
this manual. The calculator and the HTML manual are available for download 
from http://service.real.com/help/library/encoders.html. Use the 
calculator to derive a detailed picture of RealPix bandwidth usage. You may 
want to do this if you experience high preroll when streaming your 
presentation. You can then determine where the problem occurs and resolve it 
by modifying image size or adjusting the timeline. 

In the calculator you can enter RealPix information manually, or read ina 
RealPix (.rp) file to gather the image file names and display times. The 
calculator will also load the image sizes automatically. To be read 
automatically, a RealPix file must meet these criteria: 


- It must follow the guidelines in “Syntax Rules” on page 18. All attribute 
values must be in double quotation marks, for example. 


+ Comments must be in the form <!-- comment --> and not <!-- comment --/>. 


In the calculator, make sure that the RealPix bit rate is set correctly. This 
reflects the RealPix bandwidth target set in the <head/> tag bitrate attribute 
(see page 20). The example below uses 20 Kbps, the bandwidth target for a 
presentation delivered over a 28.8 Kbps modem. Set the buffer time to your 
targeted preroll, which should be approximately 10 seconds. 
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Presentation Information in RealPix Bandwidth Calculator 


Presentation Information 
Current RP File Output Directory 
graphics 
Total Bit Rate 


RealPix Bit Rate RealPix Buffer Time (secs) 


Remaining Bit Rate 





Additional Information 


See “Targeting a Bit Rate” on page 51. 


When setting values manually, enter file names (not shown below) and image 
sizes in Kilobytes, along with the times each image first displays. These values 
go in the white columns. The calculator computes the values in gray. When 
you load a RealPix file automatically, the calculator adds an entry for each 
effect. After the first effect that uses an image, though, RealPlayer has the 
image in memory, so the entries for subsequent effects show that image as 0 
Kb. You can ignore these entries and examine only the initial appearance of 
each image. 


Based on the image sizes, the calculator computes the transmission time in 
seconds for each image. This is the time it takes RealServer to stream the 
image to RealPlayer at the presentation bit rate. The last column shows the 
earliest display time for each file. This reflects the earliest time in the RealPix 
timeline the image can appear. The calculator derives this time by subtracting 
the presentation preroll from the cumulative image transmission times. 


RealPix Bandwidth Calculator Showing Presentation that will not Stream Well 


Image Size (Kb) Transmission Time (sec) Display Time (from rp file) Earliest Display Time 





The example above illustrates a RealPix presentation that will not stream with 
the desired preroll of 10 seconds. It shows, for example, that the first image 
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can display at 2.3 seconds into the timeline at the earliest. The image is slated 
to appear at 1 second after the start of playback, however. The calculator flags 
this display time in red to indicate the problem. As shown above, only the fifth 
image can display at its slated time of 84 seconds. 


Were it to stream this RealPix presentation, RealSystem would compensate 
with a preroll higher than the desired 10 seconds. Although the presentation 
would stream smoothly, viewers would have to wait too long for playback. (To 
determine the actual preroll for a presentation, increase the preroll value until 
all display time values turn black.) 


To improve a presentation’s performance, you can take steps described in 
“Lowering Bandwidth Consumption” on page 56. Then reload the RealPix file 
into the spreadsheet or update the image sizes and display times manually. 
The following figure illustrates a revised presentation that makes better use of 
bandwidth. 


RealPix Bandwidth Calculator Showing Presentation that will Stream Well 


Image Size (Kb) Transmission Time (sec) _—_ Display Time (from rp file) Earliest Display Time 





In this example the preroll is still 10 seconds, but files 1 through 3 are reduced 
in size. The entire presentation is lengthened and the images appear at more 
even intervals within the timeline. All display time values are now in black. 
The first image shows its earliest display time in green as (1.1). This indicates 
that the preroll is 1.1 seconds longer than necessary to display this image. If 
the earliest display times for all images appears in green, the actual preroll will 
be lower than the value listed in the calculator. 


Running JPEGTRAN from the Calculator 


As described in “Using JPEGTRAN” on page 9, you run JPEGTRAN on JPEG 
images to prepare them for streaming. On Windows, you can run JPEGTRAN in 
a batch conversion mode from the RealPix spreadsheet as described below. 


> To run JPEGTRAN from the spreadsheet: 


1. Click the Find JPEGTran button and navigate to the directory that holds 
the executable program. Select the program and click Open. 
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2. In the Output Directory field, enter the directory that will hold the 
processed files. The directory syntax can be absolute or relative to the 
directory that holds the spreadsheet. 


3. Click JPEGTran Images and select the images you want to process. A DOS 
command window pops-up momentarily for each image. Processed files 
appear in the specified output directory. 


Lowering Bandwidth Consumption 


If your presentation requires too much initial buffering, you can take several 
steps to lower the preroll. You can modify your RealPix presentation or 
balance multiple media types so that initial presentation bandwidth needs are 
low. This gives RealSystem extra bandwidth when the presentation starts to 
stream the higher bit rate items required later in the timeline. 


Lowering RealPix Preroll 


Within the RealPix presentation, you can do the following to lower bandwidth 
consumption: 


- Crop out unused portions of the source files. This lowers the source file 
sizes, making more efficient use of bandwidth than cropping images by 
defining source rectangles through RealPix mark-up tags. 


- Reduce the resolution and number of colors in images while maintaining 
satisfactory image quality. For JPEG files, experiment with higher 
compression rates. 


- Use smaller images at the beginning of the presentation. They will stream 
to RealPlayer faster and RealServer can use the extra bandwidth to start 
delivering larger files needed later. 


+ Introduce images gradually over the timeline. Don’t use rapid effects with 
alot of images at the beginning of the presentation. Once you have 
displayed all images, however, you can use rapid effects because RealPlayer 
holds the image data in memory. 


- Increase the length of the presentation by, for example, adding an extra 
second to the duration time of each effect. 
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Masking Preroll using Other Media 


When you stream RealPix along with a low-bandwidth media file, you can 
mask the RealPix preroll so that it takes place while the other file plays. For 
example, start the presentation with RealText (to display opening credits, for 
example) or a low-bandwidth RealAudio file (as a narration, for instance) to 
consume from 1 to 5 Kbps at the start of the presentation. 


As these files play, RealServer takes advantage of the extra bandwidth available 
in the connection to stream the RealPix preroll. If RealPix starts 20 seconds 
after the RealAudio or RealText file, for example, you make 300 to 380 
Kilobits available (at 20 Kbps) for the RealPix preroll. To do this, you assemble 
the overall presentation with a SMIL file, put all files in a <par> group, and set 
a 20-second delay for RealPix. 


Additional Information 
For more on masking preroll, see the appendix on 
advanced production techniques in RealSystem 
Production Guide. For more on RealText, see RealText 
Authoring Guide. You can download both guides from 
http://service.real.com/help/library/encoders.html. 
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<head/> 

Attribute Definition Required Default Example 

aspect Default for maintaining no true aspect="false" 
aspect ratio of images. 

author Name of author. no (none) author="Jane Doe" 

background-color | Initial background color. no black background-color= 

"H#FE3434" 

bitrate Peak bandwidth in bits per | yes (none) bitrate="64000" 
second. 

copyright Copyright notice. no (none) copyright="(c) 1998 

RealNetworks, Inc." 

duration Duration of RealPix yes (none) duration="50" 
presentation. 

height Height of display window in | yes (none) height="256" 
pixels. 

maxfps Maximum frames per no calculated maxfps="5" 
second for transition effects. automatically 
(Include as last attribute.) 

preroll Time for which initial data | no calculated preroll="20" 
should be buffered. automatically 

timeformat Format for time attributes: | yes milliseconds |timeformat= 
dd:hh:mm:ss.xyz or "dd:hh:mm:ss.xyz" 
milliseconds. 

title Name of presentation. no (none) title="The Garden" 

url Hyperlink URL for no (none) url="http://www.real.com" 
presentation images. 

width Width of display window in | yes (none) width="256" 
pixels. 
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<image/> 

Attribute Definition Required Default Example 

handle | Unique number for the image. Referred to by | yes (none) | handle="23" 
certain effects. 

name Path to the image file, relative to the location | yes (none) name="tulip.jpg" 
of the RealPix file. 

size Size of image file in bytes. no (none) | size="24000" 

mime Mime type of image file. no (none) mime="image/jpeg" 

<fill/> 

Attribute Definition Required Default Example 

color Hexadecimal color description or standard yes (none) color="yellow" 
palette color. 

dsth Height in pixels of destination rectangle. no 0 dsth="256" 

dstw Width in pixels of the destination rectangle. no 0 dstw="256" 

dstx X coordinate in pixels of the destination no 0 dstx="128" 
rectangle. 

dsty Y coordinate in pixels of the destination no 0 dsty="128" 
rectangle. 

start Time from the start of the RealPix presentation | yes (none) start="23" 
that the fill occurs. 
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<fadein/> 

Attribute — Definition Required Default Example 

aspect Maintain image aspect ratio, no set in <head/> | aspect="false" 
true or false. 

dsth Height in pixels of the no 0 dsth="128" 
destination rectangle. 

dstw Width in pixels of the no 0 dstw="128" 
destination rectangle. 

dstx X coordinate in pixels of the no 0 dstx="20" 
destination rectangle. 

dsty Y coordinate in pixels of the no 0 dsty="30" 
destination rectangle. 

duration | Time for the effect to complete. | yes (none) duration="0.75" 

maxfps Maximum frames per second | no set in <head/> | maxfps="5" 
for effect. (Include as last 
attribute.) 

srch Height in pixels of source no 0 srch="128" 
rectangle. 

srcw Width in pixels of source no 0 srcw="128" 
rectangle. 

STCX X coordinate in pixels of the no 0 srex="128" 
source rectangle. 

srcy Y coordinate in pixels of the no 0 srcy="128" 
source rectangle. 

start Time from the beginning of the | yes (none) start="4" 
RealPix presentation that the 
effect begins. 

target Target image handle. yes (none) target="15" 

url Hyperlink URL for image. no set in <head/> | url="http://www.real.com" 
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<fadeout/> 

Attribute Definition Required Default Example 

color Hexadecimal color description or standard | yes (none) color="black" 
palette color. color="#FF8000" 

dsth Height in pixels of the destination rectangle. | no 0 dsth="128" 

dstw Width in pixels of the destination rectangle. | no 0 dstw="128" 

dstx X coordinate in pixels of the destination no 0 dstx="128" 
rectangle. 

dsty Y coordinate in pixels of the destination no 0 dsty="128" 
rectangle. 

duration | Total time for the transition to complete. yes (none) duration="1.2" 

maxfps Maximum frames per second for effect. no set in <head/> | maxfps="5" 
(Include as last attribute.) 

start Time from the beginning of the RealPix yes (none) start="10" 
presentation that the effect begins. 
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<crossfade/> 

Attribute — Definition Required Default Example 

aspect Maintain image aspect ratio, true | no set in <head/> | aspect="false" 
or false. 

dsth Height in pixels of the destination | no 0 dsth="64" 
rectangle. 

dstw Width in pixels of the destination | no 0 dstw="64" 
rectangle. 

dstx X coordinate in pixels of the no 0 dstx="64" 
destination rectangle. 

dsty Y coordinate in pixels of the no 0 dsty="64" 
destination rectangle. 

duration | Total time for the transition to yes (none) duration="1.8" 
complete. 

maxfps Maximum frames per second for | no set in <head/> | maxfps="5" 
effect. (Include as last attribute.) 

srch Height in pixels of the source no 0 srch="128" 
rectangle. 

srcw Width in pixels of the source no 0 srcw="128" 
rectangle. 

STCX X coordinate in pixels of the source | no 0 srcx="64" 
rectangle. 

srcy Y coordinate in pixels of the source | no 0 srcy="64" 
rectangle. 

start Time from the beginning of the yes (none) start="20" 
presentation that the crossfade 
begins. 

target Target image handle. yes (none) target="1" 

url Hyperlink URL for image. no set in <head/> | url="http://www.real.com" 
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<animate/> 

Attribute — Definition Required Default Example 

aspect Maintain image aspect ratio, no set in <head/> | aspect="false" 
true or false. 

dsth Height in pixels of the no 0 dsth="60" 
destination rectangle. 

dstw Width in pixels of the no 0 dstw="468" 
destination rectangle. 

dstx X coordinate in pixels of the no 0 dstx="10" 
destination rectangle. 

dsty Y coordinate in pixels of the no 0 dsty="15" 
destination rectangle. 

duration | Total time the GIF animates. _| yes (none) duration="45" 

maxfps Maximum frames per second | no set in <head/> | maxfps="5" 
for animation. (Include as last 
attribute.) 

srch Height in pixels of source no 0 srch="56" 
rectangle. 

srcw Width in pixels of source no 0 srcw="234" 
rectangle. 

STCX X coordinate in pixels of the no 0 srex="117" 
source rectangle. 

srcy Y coordinate in pixels of the no 0 srcy="2" 
source rectangle. 

start Time from the beginning of the | yes (none) start="14" 
RealPix presentation that the 
animation starts. 

target Target image handle. yes (none) target="15" 

url Hyperlink URL for image. no set in <head/> | url="http://www.real.com" 
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<wipe/> 

Attribute — Definition Required Default Example 

aspect Maintain image aspect ratio, true | no set in <head/> | aspect="false" 
or false. 

direction | Direction the new image moves: yes (none) direction="up" 
up, down, left, or right. 

dsth Height in pixels of the destination | no 0 dsth="64" 
rectangle. 

dstw Width in pixels of the destination | no 0 dstw="64" 
rectangle. 

dstx X coordinate in pixels of the no 0 dstx="64" 
destination rectangle. 

dsty Y coordinate in pixels of the no 0 dsty="64" 
destination rectangle. 

duration | Time for the transition to yes (none) duration="3.5" 
complete. 

maxfps Maximum frames per second for | no set in <head/> | maxfps="5" 
effect. (Include as last attribute.) 

srch Height in pixels of the source no 0 srch="64" 
rectangle. 

srcw Width in pixels of the source no 0 srcw="64" 
rectangle. 

STCX X coordinate in pixels of the source | no 0 srcx="64" 
rectangle. 

srcy Y coordinate in pixels of the source | no 0 srcy="64" 
rectangle. 

start Time from the beginning of the yes (none) start="25" 
presentation that the wipe begins. 

target Target image handle. yes (none) target="2" 

type How the wipe occurs, either sliding | yes (none) type="push" 
over the current image (normal) or 
pushing it out (push). 

url Hyperlink URL for image. no set in <head/> | url="http://www.real.com" 
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<viewchange/> 

Attribute — Definition Required Default Example 

dsth Height in pixels of the destination no 0 dsth="64" 
rectangle. 

dstw Width in pixels of the destination rectangle. | no 0 dstw="64" 

dstx X coordinate in pixels of the destination _| no 0 dstx="64" 
rectangle. 

dsty Y coordinate in pixels of the destination no 0 dsty="64" 
rectangle. 

duration | Time for the effect to complete. yes (none) duration="5" 

maxfps Maximum frames per second for effect. no set in <head/> | maxfps="5" 
(Include as last attribute.) 

srch Height in pixels of the source rectangle. no 0 srch="256" 

srcw Width in pixels of the source rectangle. no 0 srcw="256" 

STCX X coordinate in pixels of the source no 0 srcx="512" 
rectangle. 

srcy Y coordinate in pixels of the source no 0 srcy="64" 
rectangle. 

start Time from the beginning of the yes (none) start="35" 














presentation that the view change begins. 
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